Currently, eVa AI API are only available for: eth, bsc, base, sonic

Request an API key here: https://t.me/EvaAISupportBot

Monitor your api usage and credits here: https://t.me/eVa_Tracking_Bot

(command is /api <YOUR_API_KEY>)

Fetch full audit by chain and contract address for any Token (Limited 60 requests per minute)

get

Retrieves full token audit information based on the specified blockchain and contract address.

Path parameters

chainstring · enumRequired

The blockchain network (eth, bsc, base, sonic)

Example: ethPossible values:

contractAddressstringRequired

The contract address of the token to audit

Example: 0xYourContractAddress

Responses

200

Successfully fetched the full audit

application/json

400

Bad Request: Invalid chain, address, or token

application/json

403

Forbidden: Invalid API key

application/json

429

Rate limit exceeded

application/json

500

Internal server error

application/json

get

/getAuditbyToken/{chain}/{contractAddress}

JavaScriptPythoncURL

const response = await fetch(`https://api.eva-ai.cloud/getAuditbyToken/{chain}/{contractAddress}`, {
  method: 'GET',
  headers: {
    'x-api-key': 'your-api-key'
  }
});

const data = await response.json();
console.log(data);

{
  "name": "LILY",
  "symbol": "LILY",
  "decimals": 18,
  "owner": "0xOwnerAddressHere",
  "formattedTotalSupply": 1000000000,
  "clog_perc": 0.05,
  "topHolder_perc": "20%",
  "topholdersAnalyzed": 100,
  "topHolders_perc": "15%",
  "AIaudit": {
    "findings": [
      {
        "rating": "🔴",
        "issue": "Potential malicious behavior detected."
      }
    ],
    "Privileges": "🔴",
    "MaliciousCode": "🔴",
    "TaxStructure": {
      "Initial Taxes": "15% Buy, 15% Sell",
      "Final Taxes": "0% Buy, 0% Sell",
      "Reduced after": "5 buys"
    },
    "TransactionLimit": "8,400,000,000 tokens",
    "EnforcedFor": "Until the owner removes limits using `removeLimits()`"
  }
}

Audit any contract address or token (Limited 60 requests per minute)

get

Retrieves audit information based on the specified blockchain and any contract address.

Path parameters

chainstring · enumRequired

The blockchain network (eth, bsc, base, sonic)

Example: ethPossible values:

contractAddressstringRequired

The contract address of the token to audit

Example: 0xYourContractAddress

Responses

200

Successfully fetched the audit

application/json

400

Bad Request: Invalid chain or contract address

application/json

403

Forbidden: Invalid API key

application/json

404

Audit or source code not found

application/json

429

Rate limit exceeded

application/json

500

Internal server error

application/json

get

/getAuditbyAddress/{chain}/{contractAddress}

JavaScriptPythoncURL

const response = await fetch(`https://api.eva-ai.cloud/getAuditbyAddress/{chain}/{contractAddress}`, {
  method: 'GET',
  headers: {
    'x-api-key': 'your-api-key'
  }
});

const data = await response.json();
console.log(data);

{
  "name": "LILY",
  "executiveSummary": {
    "findings": [
      {
        "rating": "🔴",
        "issue": "Potential malicious behavior detected."
      }
    ],
    "Privileges": "🔴",
    "MaliciousCode": "🔴",
    "TaxStructure": {
      "Initial Taxes": "15% Buy, 15% Sell",
      "Final Taxes": "0% Buy, 0% Sell",
      "Reduced after": "5 buys"
    },
    "TransactionLimit": "8,400,000,000 tokens",
    "EnforcedFor": "Until the owner removes limits using `removeLimits()`"
  }
}

Get the latest ETH LP lock + audit (100 requests per minute)

get

Retrieves the latest LP lock detected by eVa, inclusive of parameters and audit info

Responses

200

Successfully fetched latest lock

application/json

namestringOptional

Name of the token

Example: LILY

symbolstringOptional

Symbol of the token

Example: LILY

addressstringOptional

Contract address of the token

Example: 0xYourContractAddress

clognumberOptional

Clogging percentage of the token

Example: 0.05

renouncedstringOptional

Owner's address, indicating renouncement status if applicable

Example: 0xOwnerAddressHere

lpLockedPercentagenumberOptional

Percentage of liquidity locked

Example: 25.3

LPvaluenumberOptional

Value of the locked liquidity in ETH

Example: 200000

percLockednumberOptional

Percentage of the token supply that is locked

Example: 85.6

marketcapnumberOptional

Market capitalization of the token

Example: 10000000

evaTimeintegerOptional

Timestamp for the latest lock, in seconds since epoch

Example: 1690000000

400

Bad Request: Invalid chain or contract address

application/json

get

/getLatestLock

JavaScriptPythoncURL

const response = await fetch(`https://api.eva-ai.cloud/getLatestLock`, {
  method: 'GET',
  headers: {
    'x-api-key': 'your-api-key'
  }
});

const data = await response.json();
console.log(data);

{
  "name": "LILY",
  "symbol": "LILY",
  "address": "0xYourContractAddress",
  "clog": 0.05,
  "renounced": "0xOwnerAddressHere",
  "lpLockedPercentage": 25.3,
  "LPvalue": 200000,
  "audit": {
    "findings": [
      {
        "rating": "🔴",
        "issue": "Potential malicious behavior detected."
      }
    ],
    "Privileges": "🔴",
    "MaliciousCode": "🔴",
    "TaxStructure": {
      "Initial Taxes": "15% Buy, 15% Sell",
      "Final Taxes": "0% Buy, 0% Sell",
      "Reduced after": "5 buys"
    },
    "TransactionLimit": "8,400,000,000 tokens",
    "EnforcedFor": "Until the owner removes limits using `removeLimits()`"
  },
  "percLocked": 85.6,
  "marketcap": 10000000,
  "evaTime": 1690000000
}

Generate an audit given any code snippet regardless of the chain.

post

Generate an audit based on the specified code snippet, without requiring chain or contract details.

Body

application/json

codeSnippetstringRequired

The Solidity code snippet to audit.

Responses

200

Successfully fetched the audit

application/json

400

Bad Request: Code snippet is required

application/json

403

Forbidden: Invalid API key

application/json

404

Audit or source code not found

application/json

429

Rate limit exceeded

application/json

500

Internal server error

application/json

post

/getAuditbyCode

JavaScriptPythoncURL

const response = await fetch('https://api.eva-ai.cloud/getAuditbyCode', {
  method: 'POST',
  headers: {
    'x-api-key': 'your-api-key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    codeSnippet: `pragma solidity ^0.8.0;

contract HelloWorld {
    string public greet = "Hello, World!";
}`
  })
});

const data = await response.json();
console.log(data);

{
  "executiveSummary": {
    "findings": [
      {
        "rating": "🔴",
        "issue": "Potential malicious behavior detected."
      }
    ],
    "Privileges": "🔴",
    "MaliciousCode": "🔴",
    "TaxStructure": {
      "Initial Taxes": "15% Buy, 15% Sell",
      "Final Taxes": "0% Buy, 0% Sell",
      "Reduced after": "5 buys"
    },
    "TransactionLimit": "8,400,000,000 tokens",
    "EnforcedFor": "Until the owner removes limits using `removeLimits()`"
  }
}